/* @(#) somx/readme 2.3 1/20/94 10:20:39 [5/15/94 18:01:15] */

/*
 * 96F8647, 96F8648, 96F8850 (C) Copyright IBM Corp. 1992, 1994
 * All Rights Reserved
 * Licensed Materials - Property of IBM
 *
 * DISCLAIMER OF WARRANTIES.
 * The following [enclosed] code is sample code created by IBM
 * Corporation. This sample code is not part of any standard or IBM
 * product and is provided to you solely for the purpose of assisting
 * you in the development of your applications.  The code is provided
 * "AS IS". IBM MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT
 * NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 * FOR A PARTICULAR PURPOSE, REGARDING THE FUNCTION OR PERFORMANCE OF
 * THIS CODE.  IBM shall not be liable for any damages arising out of
 * your use of the sample code, even if they have been advised of the
 * possibility of such damages.
 *
 * DISTRIBUTION.
 * This sample code can be freely distributed, copied, altered, and
 * incorporated into other software, provided that it bears the above
 * Copyright notice and DISCLAIMER intact.
 */

This directory contains sample subclasses of the SOM Persistence Framework.

To build these sample programs, make sure that the SOM environment variables
have been set up in config.sys by the installation program or by running
the somenv.cmd program. Then, in this directory, run:

Enter the command:

   wmake /f makefile.wmk

to build these samples.

When you run "make" you will build:

1. sompini.lib and sompini.dll which contain:

   - a sample Media Interface class (SOMPIniMediaInterface) implementation
     which is a low-level interface to OS/2 .INI files. (This class is stubbed
     out for the AIX implementation so while the code compiles, it can perform
     no I/O.)

   - a sample I/O Group Manager class (SOMPIni) implementation which uses the
     SOMPIniMediaInterface class.

   - the prftest.exe program drives these new classes.

2. a sample program (prftest.exe) which stores/restores using the SOMPIni I/O
   Group Mgr class. Run this program when make completes.

3. student.lib and student.dll which contain:

   - a persistent object class (PersistentStudent) which is used by the
     prftest sample program.

4. template.lib and template.dll which contain:

   - a sample template I/O Group Manager class (SOMPTemplate) which can
     be used as a starting point for creating your own I/O Group Manager
     implemenation. Their is no sample program which drives the template
     Group Manager.

5. emi.lib and emi.dll

   - these are examples from the documentation which illustrate an
     enhancement to an existing Media Inteface class (enfmi) and its
     companion I/O Group Mgr class (fsen). Their is no sample program
     which drives these classes.

